Image Class

Description

Image stores an image data and represents an image in memory.

Image raw data can be accessed as byte array. The width/height/etc information are also accessible.

You can always access image data since the first version of EasyAR Sense.

You can do this in iOS

#import <easyar/buffer.oc.h>
#import <easyar/image.oc.h>

easyar_OutputFrame * outputFrame = [outputFrameBuffer peek];
if (outputFrame != nil) {
    easyar_Image * i = [[outputFrame inputFrame] image];
    easyar_Buffer * b = [i buffer];
    char * bytes = calloc([b size], 1);
    memcpy(bytes, [b data], [b size]);
    // use bytes here
    free(bytes);
}

Or in Android

import cn.easyar.*;

OutputFrame outputFrame = outputFrameBuffer.peek();
if (outputFrame != null) {
    InputFrame inputFrame = outputFrame.inputFrame();
    Image i = inputFrame.image();
    Buffer b = i.buffer();
    byte[] bytes = new byte[b.size()];
    b.copyToByteArray(0, bytes, 0, bytes.length);
    // use bytes here
    b.dispose();
    i.dispose();
    inputFrame.dispose();
    outputFrame.dispose();
}

Constructor

C: void easyar_Image__ctor(easyar_Buffer * buffer, easyar_PixelFormat format, int width, int height, easyar_Image * * Return)
C++17: Image(std::shared_ptr<Buffer> buffer, PixelFormat format, int width, int height)
Traditional C++: Image(Buffer * buffer, PixelFormat format, int width, int height)
Java: public Image(@Nonnull Buffer buffer, int format, int width, int height)
Kotlin: constructor(buffer: Buffer, format: Int, width: Int, height: Int)
Objective-C: + (easyar_Image *) create:(easyar_Buffer *)buffer format:(easyar_PixelFormat)format width:(int)width height:(int)height
Swift: public convenience init(_ buffer: Buffer, _ format: PixelFormat, _ width: Int32, _ height: Int32)
C#: public Image(Buffer buffer, PixelFormat format, int width, int height)

buffer

Returns buffer inside image. It can be used to access internal data of image. The content of Buffer shall not be modified, as they may be accessed from other threads.

C: void easyar_Image_buffer(const easyar_Image * This, easyar_Buffer * * Return)
C++17: std::shared_ptr<Buffer> buffer()
Traditional C++: void buffer(Buffer * * Return)
Java: public @Nonnull Buffer buffer()
Kotlin: fun buffer(): Buffer
Objective-C: - (easyar_Buffer *)buffer
Swift: public func buffer() -> Buffer
C#: public virtual Buffer buffer()

format

Returns image format.

C: easyar_PixelFormat easyar_Image_format(const easyar_Image * This)
C++17: PixelFormat format()
Traditional C++: PixelFormat format()
Java: public int format()
Kotlin: fun format(): Int
Objective-C: - (easyar_PixelFormat)format
Swift: public func format() -> PixelFormat
C#: public virtual PixelFormat format()

width

Returns image width.

C: int easyar_Image_width(const easyar_Image * This)
C++17: int width()
Traditional C++: int width()
Java: public int width()
Kotlin: fun width(): Int
Objective-C: - (int)width
Swift: public func width() -> Int32
C#: public virtual int width()

height

Returns image height.

C: int easyar_Image_height(const easyar_Image * This)
C++17: int height()
Traditional C++: int height()
Java: public int height()
Kotlin: fun height(): Int
Objective-C: - (int)height
Swift: public func height() -> Int32
C#: public virtual int height()

empty

Checks if the image is empty.

C: bool easyar_Image_empty(easyar_Image * This)
C++17: bool empty()
Traditional C++: bool empty()
Java: public boolean empty()
Kotlin: fun empty(): Boolean
Objective-C: - (bool)empty
Swift: public func empty() -> Bool
C#: public virtual bool empty()